The Keychain Manager provides two functions to create a keychain reference. A keychain reference is a reference to an opaque structure that contains information about the keychain. The Keychain Manager uses a keychain reference to uniquely identify a keychain. The function KCMakeKCRefFromFSSpec enables you to create a keychain reference from a file specification record. The function KCMakeKCRefFromAlias enables you to create a keychainreference from a handle to an alias. You can create an alias from a keychain reference by calling the function KCMakeAliasFromKCRef.
Your application should not assume a keychain is a file, because keychains may be stored on other media (such as a smart card) in future versions of Keychain Manager.
After you are finished with a keychain reference, you should call the function KCReleaseKeychain to dispose of the memory it occupied. On return, KCReleaseKeychain sets the reference to
NULL
. You should not use it after this.